home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / translit.arc / TRANSLIT.DOC < prev   
Encoding:
Text File  |  1985-08-08  |  1.8 KB  |  54 lines
  1.  
  2.                 TRANSLIT
  3.  
  4.        This program translates input from standard input to 
  5.     standard output, using "from" and "to" conversion sets,
  6.     which are read from the    command line.
  7.  
  8.     This program is based on a RATFOR version published in
  9.     "Software Tools" by Kernighan and Plaguer.
  10.     Converted by:
  11.         Kevin Rosenberg
  12.         324 Tangelo
  13.         Irvine, CA 92714
  14.         (714) 857-2123
  15.         CompuServe 73775,1232
  16.  
  17. usage: translit from to [<infile] [>outfile]
  18.     If no input file if given, input is read from then keyboard.
  19.     If no output file id given, output is sent to the screen.
  20.  
  21. Special Characters that can be used in "from" & "to" sets                        
  22.     dash, -, fills a set
  23.         a-d = abcd, 5-8 = 5678
  24.     caret, ^, means everything but set
  25.         ^a-z = everthing but lower case letters
  26.     escape, \, used to get special character
  27.         \n = newline, \b = blank, \t = tab
  28.  
  29. Examples:
  30.    translit a-z A-Z <file.dat
  31.     converts lower case to upper case
  32.     input is read from "file.dat" & output is sent to screen
  33.  
  34.    translit A-za-z A-Za-z
  35.     converts lower case to upper case & upper case to lower case
  36.     input is read from keyboard & output is sent to screen
  37.  
  38. Special cases of "to" set being shorter than "from" set
  39. 1.    If "to" set is shorter than "from" set, then a sequence of
  40.     characters that are in "from" are collapsed to a single
  41.     character of the "to" set. The first character of "to" set is
  42.     used.
  43.     e.g.    translit \b\t\n \n
  44.             converts strings to white space to a newline
  45.         translit 0-9 n
  46.             converts strings of digits to a single n
  47.  
  48. 2.    If no "to" set given, then everything that is in "from"
  49.     set is deleted.
  50.     e.g.   translit ^0-9. <text.dat >prn:
  51.         deletes everything but digits & decimal point
  52.         input is from text.dat & output is sent to the printer device.
  53.  
  54.